home *** CD-ROM | disk | FTP | other *** search
/ Aminet 8 / Aminet 8 (1995)(GTI - Schatztruhe)[!][Oct 1995].iso / Aminet / dev / gui / gutil_dev_3652.readme < prev    next >
Text File  |  1995-09-20  |  16KB  |  320 lines
  1. Short:    GUI creation library (small & fast)
  2. Author:   P-O Yliniemi / Staffan Hämälä
  3. Uploader: P-O Yliniemi
  4. Type:     dev/gui
  5.  
  6. This library is currently in its ßeta testing stage. The only thing that
  7. is missing is some of the docs. All advanced functions are described, and
  8. all less advanced functions have at least a short usage docs.
  9.  
  10. Some examples may have weird names (for those who don't understand swedish),
  11. and some text files may be in swedish. This will be fixed for next release.
  12.  
  13. Two versions of the .library file is available with this developer package.
  14. One is the "normal" library, and the other one prints out a lot of info when
  15. executing a program that uses GadUtil.
  16.  
  17. If you need to use the debug version, rename the normal version in libs:,
  18. copy the debug version to libs, and rename it to gadutil.library. Reverse
  19. this to change back to the normal version. Don't forget to "flush" all
  20. unused libraries or reboot before testing the program again.
  21.  
  22. All necessary files for Asm & C development are included.
  23.  
  24.                                           P-O 950626
  25.                                           ~~~~~~~~~~
  26.  
  27. ;----------------------------------------------------------------------------
  28.  
  29.                             GadUtil.library v36.52
  30.                             ~~~~~~~~~~~~~~~~~~~~~~
  31.     GadUtil is another gui library which main goal was to make it easy to
  32.     create font sensitive user interfaces. The library has grown away from
  33.     this main goal, and become another useful-routine-library.
  34.  
  35.   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  36.     Distribution:
  37.  
  38.         1) Distribution of this library is allowed in two ways:
  39.              ¹) Only the .library file
  40.              ²) The complete distribution
  41.  
  42.         2) Programmers of totally free software can use and distribute this
  43.           library for free.
  44.  
  45.         3) Programmers of Shareware, Licensware, commercial products and other
  46.            programs that the programmer get any kind of profit from shall send
  47.            a fully working (and registered) copy of the program and its docs to
  48.            us. All larger updates of the program should also be sent to us.
  49.           
  50.         4) Programmers of non-free software not covered by 1) and 2) (my Diskware
  51.            concept belongs to this group) shall be treated as in 3) (a fully
  52.            working and registered copy...).
  53.  
  54.         5) All programs (except commercial products in some cases) must state
  55.            that gadutil.library is used. This may be done in either the About
  56.            requester or in the documentation, but best of all in both places.
  57.  
  58.            Demonstration programs for gadutil.library (that includes the full
  59.            source) may be distributed without this note.
  60.  
  61.            Example for inclusion in About requester:
  62.  
  63.                 "This program uses gadutil.library, which
  64.                  is Copyright © 1994-1995 by P-O Yliniemi
  65.                  and Staffan Hämälä."
  66.  
  67.         6) All localized programs that uses this library should include the
  68.            .ct file(s) to allow anyone to translate that program into their
  69.            own language.
  70.  
  71.  
  72.   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  73.     Below is a list of some of the main functions covered by this library.
  74.  
  75.     * FAST (NO OR VERY SMALL DIFFERENCE AGAINST GADTOOLS) AND SMALL (LESS THAN 10k).
  76.       WRITTEN IN ASSEMBLY LANGUAGE. NO F*CKING 'C' or any other slow language!
  77.  
  78.     * Font adaptive. Use any of the system fonts and most other fonts for
  79.       gadgets, texts and menus. All gadgets are placed relative to each
  80.       other, but can be placed at absolute positions (needed for the first
  81.       gadget).
  82.  
  83.     * No need to use GIMMEZEROZERO windows, as this is automatically handled
  84.       by the library. If you specify a gadget position of 10,10 the gadget
  85.       will be placed at 10,10 within the window's border.
  86.  
  87.     * Localized. It is really easy to localize all your (new) programs by
  88.       using this library. Functions and macros for creating localized menus
  89.       are supplied.
  90.  
  91.     * Both assembly and 'C' language support. This is one of the things that is
  92.       missing in most of the other gui libraries. Some extra macros are defined
  93.       for assembly language users, and will make the gadget and menu creating
  94.       process even more easy.
  95.  
  96.     * All GadTools gadgets are supported. Some extra functions are provided
  97.       for ListViews. BUTTON_KIND (and IMAGE_KIND) gadgets have some extra tags,
  98.       including a toggle-select option.
  99.  
  100.       4 extended gadget types are handled by the library:
  101.     
  102.         · FILE_KIND     - gadget for selecting a file.
  103.  
  104.         · DRAWER_KIND   - gadget for selecting a drawer. Most programs also
  105.                          use this gadget for file selection.
  106.  
  107.         · IMAGE_KIND    - uses an intuition image for the gadget. Can use
  108.                           different images for selected and non-selected state.
  109.  
  110.         · BEVELBOX_KIND - gadtools bevelboxes, with some extensions. All
  111.                           gadtools bevelboxes are supported (even with v37).
  112.                           Extensions allows text to be placed above, in or below
  113.                           the upper line of the box. All kinds can be inverted.
  114.  
  115.                           New for v36.52: Bevelbox text placement extended.
  116.                           3 new placements available together with the old
  117.                           ones: centered, left adjusted & right adjusted.
  118.  
  119.                           BFT_BUTTON   - GT v37 BUTTON_KIND border
  120.                           BFT_RIDGE    - GT v37 STRING_KIND border
  121.                           BFT_DROPBOX  - GT v39 BBFT_ICONDROPBOX border
  122.                           BFT_HORIZBAR - A horizontal shadowed line
  123.                           BFT_VERTBAR  - A vertical shadowed line
  124.  
  125.                           This makes it a total of 100 bevel box types. The bevel
  126.                           boxes are treated as gadgets by the library, and you
  127.                           can obtain the structure for the bevelbox in the same
  128.                           way as you get the gadget pointer.
  129.  
  130.     * A new OpenFont (graphics.library and diskfont.library replacement) is supplied.
  131.       This function will open any font (from RAM, ROM or load it from disk).
  132.  
  133.     * Functions for listviews include adding nodes (memory for the string is
  134.       allocated by the function), counting nodes, getting node pointers, clearing
  135.       a listview, attach and detach lists, moving nodes up and down.
  136.  
  137.     * No need to open gadtools.library anymore, since all gadtools functions are
  138.       provided through this library. Some (the most useable) functions from locale
  139.       library are also provided by gadutil.
  140.  
  141.     * Many libraries are opened through gadutil.library, and these library bases
  142.       are available for your own use (you don't have to open or close some libs).
  143.  
  144.     * All gadgets are created using tag lists. Every next gadget will use the
  145.       previous gadgets values as defaults. Only one call to the gadget making
  146.       routine is needed for every gadget list.
  147.  
  148.     * All gadgets can have their own hotkey. No extra work is needed by the
  149.       programmer (only one extra tag).
  150.  
  151.     * Distributed with lots of examples, mostly in assembly language, but also
  152.       in 'C'.
  153.  
  154.     * Other functions include:
  155.  
  156.         · Status change for toggle select buttons.
  157.  
  158.         · String change for STRING and TEXT_KIND gadgets.
  159.  
  160.         · Disable functions for gadgets that support the GA_Disabled tag.
  161.  
  162.         · Routines to set up a busy-pointer (available for bot v37 and v37). These
  163.           routines also blocks the input to the main window of the program.
  164.  
  165.         · Routine to check if the mouse pointer is within a gadgets box. Useful
  166.           for mouse-position sensitive appwindows.
  167.  
  168.         · Bevelbox and window refreshing functions.
  169.  
  170.     * FAST (NO OR VERY SMALL DIFFERENCE AGAINST GADTOOLS) AND SMALL (LESS THAN 10k).
  171.       WRITTEN IN ASSEMBLY LANGUAGE. NO F*CKING 'C' or any other slow language!
  172.  
  173.  
  174.   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  175.   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  176.         Per-Olof Yliniemi                           Staffan Hämälä
  177.         Muoniovaara                                 Pellovägen 268
  178.         S-980 64 Muodoslompolo                      S-957 93 Pello
  179.         SWEDEN                                      SWEDEN
  180.  
  181.         email:                                      email:
  182.           P-O_Yliniemi@spectre.talshiar.pp.se         < no address for now >
  183.  
  184.         Don't send programs through e-mail, since I have no way to regulary check
  185.         my mail!
  186.  
  187.   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  188.   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  189.  
  190.  
  191. ============================= Archive contents =============================
  192.  
  193. Original  Packed Ratio    Date     Time    Name
  194. -------- ------- ----- --------- --------  -------------
  195.      523     301 42.4% 17-Jan-95 12:18:58 +- MakeArchive -.info
  196.      564     232 58.8% 17-Jun-95 14:41:00 +CatalogUtils.info
  197.      296     144 51.3% 16-Jun-95 17:08:34 +ASM-One_Data.sd
  198.    23292   13027 44.0% 21-Feb-95 18:49:44 +FlexCat
  199.    47196   14536 69.2% 16-Jun-95 17:10:36 +FlexCat_english.guide
  200.      469     246 47.5% 16-Jun-95 17:10:36 +FlexCat_english.guide.info
  201.     1557     622 60.0% 16-Jun-95 17:52:20 +FlexCat_Quick.doc
  202.      305     160 47.5% 16-Jun-95 17:09:24 +Lattice_Data.sd
  203.    41259   14875 63.9% 25-Jun-95 22:02:36 +dev_history.guide
  204.      564     230 59.2% 20-Apr-95 20:24:32 +Docs.info
  205.     1462     360 75.3% 27-May-95 18:49:42 +00.TableOfContents
  206.     3445    1498 56.5% 18-Jun-95 20:58:26 +01.GU_LayoutGadgetsA
  207.    16685    4584 72.5% 25-Jun-95 22:12:10 +01.GU_PreliminaryDocs
  208.      374     192 48.6% 09-Jan-95 13:58:26 +02.GU_FreeLayoutGadgets
  209.     3360    1419 57.7% 17-Jun-95 15:00:10 +03.GU_CreateGadgetA
  210.     1542     725 52.9% 18-Jun-95 22:10:52 +04.GU_SetGadgetAttrsA
  211.     1761     884 49.8% 17-Jun-95 15:02:24 +05.GU_GetIMsg
  212.      727     361 50.3% 27-May-95 23:13:04 +06.GU_CountNodes
  213.      408     219 46.3% 09-Jan-95 13:59:06 +07.GU_GadgetArrayIndex
  214.      765     379 50.4% 08-Feb-95 22:45:58 +08.GU_BlockInput
  215.      598     302 49.4% 16-Jun-95 21:26:20 +09.GU_FreeInput
  216.      639     333 47.8% 18-Jun-95 21:42:58 +10.GU_FreeGadgets
  217.      445     247 44.4% 09-Jan-95 14:00:30 +11.GU_SetGUGadAttrsA
  218.     1726     799 53.7% 08-Feb-95 23:23:24 +12.GU_CoordsInGadBox
  219.     3576    1167 67.3% 16-Jun-95 20:57:00 +13.GU_GetGadgetPtr
  220.      677     350 48.3% 16-Jun-95 19:15:10 +14.GU_TextWidth
  221.      906     411 54.6% 18-Jun-95 20:18:58 +15.GU_GetLocaleStr
  222.     1877     823 56.1% 16-Jun-95 21:30:30 +16.GU_CreateLocMenuA
  223.     2238     966 56.8% 18-Jun-95 20:12:00 +17.GU_OpenCatalog
  224.      685     356 48.0% 18-Jun-95 20:17:40 +18.GU_CloseCatalog
  225.      390     209 46.4% 09-Jan-95 14:01:32 +19.GU_DisableGadget
  226.      388     219 43.5% 09-Jan-95 14:01:38 +20.GU_SetToggle
  227.      367     204 44.4% 10-Jan-95 12:37:50 +21.GU_RefreshBoxes
  228.     1062     512 51.7% 18-Jun-95 22:01:42 +22.GU_RefreshWindow
  229.      370     212 42.7% 13-Jan-95 21:45:24 +23.GU_OpenFont
  230.      317     183 42.2% 13-Jan-95 21:58:46 +24.GU_NewList
  231.      399     222 44.3% 13-Jan-95 22:02:24 +25.GU_ClearList
  232.      367     208 43.3% 13-Jan-95 22:08:42 +26.GU_DetachList
  233.      383     214 44.1% 13-Jan-95 22:11:52 +27.GU_AttachList
  234.      400     226 43.5% 11-Feb-95 12:06:16 +28.GU_AddTail
  235.      381     215 43.5% 11-Feb-95 12:04:46 +29.GU_ChangeStr
  236.      404     211 47.7% 18-Jun-95 21:34:06 +30.GU_CreateContext
  237.      539     278 48.4% 18-Jun-95 21:49:34 +31.GU_GetGadgetAttrsA
  238.      467     249 46.6% 18-Jun-95 21:42:04 +32.GU_CreateMenusA
  239.      377     206 45.3% 18-Jun-95 21:40:30 +33.GU_FreeMenus
  240.      493     259 47.4% 18-Jun-95 22:11:56 +34.GU_LayoutMenuItemsA
  241.      466     261 43.9% 18-Jun-95 22:12:42 +35.GU_LayoutMenusA
  242.      510     266 47.8% 18-Jun-95 21:45:46 +36.GU_GetVisualInfoA
  243.      396     207 47.7% 18-Jun-95 21:44:38 +37.GU_FreeVisualInfo
  244.      412     221 46.3% 18-Jun-95 21:46:46 +38.GU_BeginRefresh
  245.      423     235 44.4% 18-Jun-95 21:47:36 +39.GU_EndRefresh
  246.      441     228 48.2% 18-Jun-95 21:48:22 +40.GU_FilterIMsg
  247.      485     250 48.4% 18-Jun-95 21:50:54 +41.GU_PostFilterIMsg
  248.     1028     510 50.3% 18-Jun-95 22:09:50 +42.GU_ReplyIMsg
  249.      499     269 46.0% 18-Jun-95 21:42:34 +43.GU_DrawBevelBoxA
  250.      376     209 44.4% 11-Feb-95 12:00:16 +44.GU_FindNode
  251.      375     214 42.9% 11-Feb-95 12:05:36 +45.GU_NodeUp
  252.      383     219 42.8% 11-Feb-95 12:05:50 +46.GU_NodeDown
  253.      334     173 48.2% 09-Jan-95 14:01:46 +99.GU_NewFunction
  254.    56794   15492 72.7% 25-Jun-95 22:13:42 +BigDoc.doc
  255.    59685   15993 73.2% 25-Jun-95 22:14:34 +BigDoc.guide
  256.     1643     741 54.8% 08-Dec-94 13:57:22 +GadUtil.manual
  257.      490     203 58.5% 04-Jan-95 15:39:14 +GadUtil.manual.info
  258.     7711    2821 63.4% 26-Jun-95 07:27:40 +GUtilInfo.txt
  259.      340      97 71.4% 04-Jan-95 15:42:12 +PrivateFunctions
  260.      564     229 59.3% 17-Jun-95 14:43:32 +ExtraCmds.info
  261.    25044   14574 41.8% 17-Jun-95 14:42:44 +AskEnv
  262.    16676    8650 48.1% 05-Jan-95 20:25:34 +fd2pragma
  263.     2754    1289 53.1% 05-Jan-95 20:25:48 +fd2pragma.readme
  264.     5932    3511 40.8% 17-Jun-95 14:42:46 +XIcon
  265.     7342    1328 81.9% 02-Nov-94 13:58:34 +gadtools.tags
  266.      564     231 59.0% 20-Apr-95 20:30:36 +Include.info
  267.     3122     900 71.1% 11-Feb-95 13:35:14 +gadutil_protos.h
  268.     2304     876 61.9% 11-Feb-95 13:35:58 +gadutil_lib.fd
  269.    14051    4132 70.5% 25-Jun-95 21:55:34 +gadutil.h
  270.    14120    4390 68.9% 25-Jun-95 20:45:42 +gadutil.i
  271.     2907     866 70.2% 11-Feb-95 13:34:24 +GadUtil_Lib.i
  272.      184     128 30.4% 24-Dec-94 13:55:02 +gadutil.h
  273.     3931     671 82.9% 17-Jun-95 14:50:42 +install.script
  274.     1409     525 62.7% 01-Jun-95 19:09:50 +InstallInc.gad
  275.      549     321 41.5% 17-Jun-95 14:50:02 +InstallInc.info
  276.      564     236 58.1% 26-Jun-95 12:09:02 +libs.info
  277.    10072    5965 40.7% 26-Jun-95 12:09:02 +gadutil.library
  278.    18196    8754 51.8% 26-Jun-95 12:09:02 +gadutil.library_dbg
  279.      564     229 59.3% 20-Apr-95 20:28:32 +Testprogram.info
  280.     7009    2581 63.1% 20-Apr-95 19:59:30 +- GadToolsBugg.s -
  281.      564     230 59.2% 20-Apr-95 20:29:52 +AnyProgram.info
  282.     1261     625 50.4% 23-Feb-95 17:17:12 +- Läs den här -
  283.     1059     550 48.0% 23-Feb-95 16:09:28 +anyprogram.cd
  284.     1567     800 48.9% 16-Jun-95 17:50:36 +anyprogram.ct
  285.    21380    6956 67.4% 12-Apr-95 22:39:16 +AnyProgram.s
  286.      564     226 59.9% 20-Apr-95 20:29:54 +BetterTest-C.info
  287.     8216    4688 42.9% 16-Jan-95 20:49:58 +BetterTest
  288.    12185    3511 71.1% 16-Jan-95 20:50:04 +BetterTest.c
  289.      835     395 52.6% 16-Jan-95 20:49:58 +BetterTest.info
  290.      229     134 41.4% 26-Dec-94 01:06:30 +led.asm
  291.      120     100 16.6% 26-Dec-94 01:06:32 +led.o
  292.      564     232 58.8% 20-Apr-95 20:29:42 +BetterTest.info
  293.     3252    1737 46.5% 08-Jan-95 01:58:36 +BetterTest
  294.      653     338 48.2% 16-Jun-95 20:35:54 +BetterTest.cd
  295.      563     324 42.4% 16-Jun-95 20:36:04 +BetterTest.ct
  296.    17129    5067 70.4% 12-Apr-95 22:51:14 +BetterTest.s
  297.      446     260 41.7% 12-Dec-94 23:25:18 +BetterTest.catalog
  298.    10027    2838 71.6% 20-Apr-95 20:00:10 +BevelTest.s
  299.     1260     496 60.6% 20-Apr-95 20:01:02 +ExternTestInit.s
  300.    13914    4475 67.8% 12-Apr-95 22:41:02 +LVTest.s
  301.    14701    4050 72.4% 16-Jun-95 20:37:16 +mytestprog.s
  302.    17285    4991 71.1% 16-Jun-95 20:38:08 +mytestprog2.s
  303.      564     232 58.8% 20-Apr-95 20:29:48 +OldInternal.info
  304.      360     226 37.2% 05-Jan-95 23:22:18 +internaltest.catalog
  305.      461     258 44.0% 05-Jan-95 23:22:22 +internaltest.cd
  306.      447     279 37.5% 05-Jan-95 23:22:22 +internaltest.ct
  307.    13755    3836 72.1% 06-Jan-95 00:47:30 +OldInternal.s
  308.      564     230 59.2% 20-Apr-95 20:29:46 +OldTestProgs.info
  309.     9953    2708 72.7% 12-Apr-95 22:47:02 +GadUtilLibTest.s
  310.     9947    2707 72.7% 20-Apr-95 20:15:46 +GadUtilLibTest2.s
  311.    16625    5298 68.1% 20-Apr-95 20:16:00 +HotKeysTest.s
  312.     1996    1055 47.1% 08-Dec-94 13:57:20 +TBLR_test
  313.    10488    2879 72.5% 20-Apr-95 20:16:38 +TBLR_test.s
  314.    11403    3149 72.3% 20-Apr-95 20:17:06 +TBLR_test2.s
  315.     8084    2829 65.0% 12-Apr-95 22:37:52 +TreGnadgetar.s
  316.      564     227 59.7% 17-Jun-95 14:43:54  GadUtil.info
  317.    11519    4004 65.2% 26-Jun-95 12:32:04  GadUtil.readme
  318. -------- ------- ----- --------- --------
  319.   662178  236510 64.2% 26-Jun-95 22:11:46   123 files
  320.